// package语句：声明当前类所在的包（类似于文件夹结构）
// 包名通常使用小写字母，采用域名倒序的方式组织
package com.itheima.comment;

// 文档注释（Javadoc注释）：以/**开始，*/结束
// 文档注释可以通过javadoc工具生成API文档
/**
 * 这是一个演示注释用法的类
 * 类名CommentDemo表示这是一个注释演示程序
 * 文档注释可以被提取生成HTML格式的API文档
 */

// public是访问修饰符，表示这个类可以被任何地方访问
// class关键字用于定义一个类
// CommentDemo是类名，遵循驼峰命名法（首字母大写）
public class CommentDemo {
    
    // 方法的文档注释
    // 用于说明方法的功能、参数和返回值等信息
    /**
     * main方法是Java程序的入口点
     * 所有Java程序都从main方法开始执行
     * @param args 命令行参数，是一个字符串数组
     */
    
    // public static void是固定格式
    // public表示公开访问，static表示静态方法（可以直接通过类调用）
    // void表示方法没有返回值
    // main是方法名，是Java规定的程序入口方法名
    // String[] args是方法参数，用于接收命令行传入的参数
    public static void main(String[] args) {
        // 单行注释：以//开始，后面的内容直到行尾都是注释
        // 单行注释是最常用的注释方式，用于解释代码行的功能
        
        // 第一行代码的注释：打印一首诗句
        // System.out.println是Java中用于输出文本到控制台的方法
        // 引号中的内容是要输出的字符串
        System.out.println("我欲乘风归去，又恐琼楼玉宇");

        /*
          多行注释：以结束
          多行注释可以跨越多行，用于解释较长的代码块
          注意：多行注释不能嵌套（不能在多行注释中再放多行注释）
        */
        
        // 下面三行代码分别打印相同的诗句
        // 每一行都是一个独立的输出语句
        System.out.println("我欲乘风归去，又恐琼楼玉宇"); // 第一行诗句输出
        System.out.println("我欲乘风归去，又恐琼楼玉宇"); // 第二行诗句输出
        System.out.println("我欲乘风归去，又恐琼楼玉宇"); // 第三行诗句输出
    }
}
